AD-A18 2  865  INTEGRAT 

COMMUNICI 
SCHENECT# 
UNCLASSIFIED  81  NOV  8! 

ED  INFORMATION  SUPPORT  SVSTEH  <IISS)  VOLUME  7  1/2  N 

IT  IONS  sues  <U>  GENERAL  ELECTRIC  CO 

IDV  NV  PRODUCTION  RESOURCES  CONSU  D  PHILLIPS 

PS-62814T288  F/G  12/7  NL 

■ 

■ 

■ 

_ ■ _ 

_ 

AD-A182  065 


fine  FILE  COPi 


AFWAL-TR-86-4006 
Vo 1 use  VII 
Part  3 


INTEGRATED  INFORMATION 
SUPPORT  SYSTEM  (IISS) 

Voluae  VII  -  Conuni  cat  ions  Subsystem 
Part  3  -  VAX  I PC  Product  Specification 


General  Electric  Coapany 
Production  Resources  Consulting 
One  River  Road 
Schenectady,  New  York  12345 


Final  Report  for  Period  22  Septeaber  1980  -  31  July  1985 
Noveaber  1985 


Approved  for  public  release;  distribution  is  unliaited. 


MATERIALS  LABORATORY 

AIR  FORCE  WRIGHT  AERONAUTICAL  LABORATORIES 
AIR  FORCE  SYSTEMS  COMMAND 
VRIGHT-PATTERSON  AFB,  OH  45433-6533 


7 

U  i 


;  b 


NOTICE 


When  Government  drawings  specifications,  or  other  data  are  used  for  any  purpose  other  than 
in  connection  with  a  definitely  related  Government  procurement  operation,  the  United  States 
Government  thereby  incurs  no  responsibility  nor  any  obligation  whatsoever ,  and  the  fact  that  the 
government  may  have  formulated  furnished  or  in  any  way  supplied  the  said  drawings 
specifications  or  other  data,  is  not  to  be  regarded  by  implication  or  otherwise  as  in  any 
manner  licensing  the  holder  or  any  other  person  or  corporation,  or  conveying  any  rights  or 
permission  to  manufacture,  use.  or  sell  any  patented  invention  that  may  in  any  way  be  related 
thereto 

This  report  has  been  reviewed  by  the  Office  of  Public  Affairs  (ASD/PA)  and  is  releasable  to  the 
National  Technical  Information  Service  (NTIS)  At  NTIS.  it  will  be  available  to  the  general 
public,  including  foreign  nations 


This  technical  report/has  been  reviewed  and  is  approved  for  publication 


" GERALD  C.  SHUMAKER,  BRANCH  CHIEF  DATE 

AFWAUMLTC 

WRIGHT  PATTERSON  AFB  OH  45433 


"If  your  address  has  changed,  if  you  wish  to  be  removed  from  our  mailing  list,  or  if  the 
addressee  is  no  longer  employed  by  your  organization  please  notify  AFWAUMLTC,  W-PAFB,  OH 
45433  to  help  us  maintain  a  current  mailing  list." 

Copies  of  this  report  should  not  be  returned  unless  return  is  required  by  security  consirioratinn* 
contractual  obligations,  or  notice  on  a  specific  document 


U  M»0«t  SI  CwB'Ti  ClAU'iCAYiO* 

Vnclassif led 


3*  SICW«iTv  C-*S*'» 'CATiON  *uTp»0«iT¥ 


7»  Dl  CLASS'*  iCaTiOM'DOwnCBaD'NC  IC"IOwU 


4.  e*  a»0«mi*.0  ORGANISATION  BICOBT  HWHIIMI 


HEPOAT  DOCUMENTATION  RAGE 


1*  «U$T»,CTiv*  MA 


•  CAtalXATlC 


Ctttrkl  lltctrie  Conpany 
Production  Resources  Consulting 


•t  4C0MU  fCir».  tmm  ms  Uf  Csss, 

1  ll*tr  Bond 
lebmeUdj.  VT  ItMS 


l»  <uM  e*  *ULD>»<04F0*»S0B'»*" 
ORGANIZATION 

Materials  Laboratory 

Air  Force  Systeas  Coaaand.  tJSAF 


At  4SDUU  ic.tj.  tmm  ms  tlf  Cmst, 

Bright -Pat tort oa  tfl.  Ohio  454 S3 


H  TiTil  tMtimSt  Itnno  CIhuAni 

(See  Reverse) 


IS.  BUT  MOBS) 

Phillips.  Donna 


19a  T**l  ©*  BteOBT  1 13a  TIM*  COV|B|0 

riaal  Tec ka leal  Report  I  U  Mfl  IMO  -  31  *Iy  IMS 


3  ©>STAiauT»ON  ACAitAOltlTY  o*  Bt>0BT 

Approved  for  public  release: 
distribution  is  unlimited 


t  M©NlT©BiN6  OBCAMltATiO*  BS*OBT  NWMtlBltl 

AFWAL-TR-86-4006  Vol  VI 1.  Part  3 


Ta  BAM*  o*  MONITOBiNG  OBGANlXATlON 

AFVAL/MLTC 


T»  aODBtss  (Cut.tm m  ms  Ilf  C mii 

VPAFB.  OH  45433-3533 


■  OAOCdBIMINT  iNSTBuMSNT  lOCKTltlCATlOB  «uw|l« 

P33615-30-C-51B5 


10  SOUAC*  or  tMNDiNG  NOS 


OB DC Bam 
IkJkMNTMO. 

▼sour 


14  BAT*  or  B*roBT  rrr .  Ms  . On,  lit  rao*  count 


BBOJtCT 

▼ASK 

HOME  UNIT 

MO. 

MO 

MO 

7500 

62 

01 

1BBS  Movaaber 


it  iwrijMiMTati  dotation  The  conputer  software  contained  herein  are  theoretical  and/or 

__  .  .  .-ni  references  that  in  no  way  reflect  Air  Force-owned  or  -developed 

SCAM  Project  Priority  saui  ©onputer  software. 


laSwaitCT  TtBMS  rCaaa nee  aa  «««  tmmsrt  a ms  «4»»a r>  Or  Mart  mmmrnri 


eoatTi  coots 


•ou* 


130B 


it  aeSTMACT  Km  tmm  m  i 


•  aft  Or  Mac*  aaMOer) 


This  document  defines  the  Product  Specification  for  the 
Interprocess  Communication  Primitives  (IPC)  configuration 
item  of  the  Integrated  Information  Support  System  (IISS) 
Test  Bed.  The  Test  Bed  is  an  integrated  hardware/software 
environment  in  which  various  Integrated  Computer  Aided 
Manufacturing  (ICAM)  Program  applications  will  function 
cooperatively.  y 


>0  OiSTMiOWTiON/AvaisASiuTt  ©*  aSSTMACT 
VMClAU'OitB'UWUMiTSe  V  SAMf  AS  BAT  C  0YlC  UMBS  Q 


**»  bam*  O*  BtPMilil  INDIVIDUAL 

Bmvid  l>.  Mian 


itbact  ucwBiTr  classic  iCATtox 
Unclassified 


IS*  T*lS»mOMI  NWWIIB 
W*rt«Ai  Am*  C mm, 

SI  3-355-3076 


DO  ROAM  1471,  S3  APR 


emtio*  o*  1 4A*>  *3  «  oasotSTS 


Sit  eMiH  STMSCk 

anrAL/m-Tc 


_ Onclasstf iod _ 

MCuAlTY  CbA3S'*)CATlOL  O*  T«*  *ACI 


Title 


Integrated  Information  Support  System  (IISS) 
Vol  VII  -  Communications  Subsystem 
Part  3  -  VAX  IPC  Product  Specification 


A  S  D  86  1438 
17  Jul  1986 


Acce?.io.i  For 


til 


NT'S  CR-a&! 

DilJ  TAB  □ 

Ucdrr.O'i  iced  □ 


Di  t  ib  jtior/ 


Availability  Codes 


|  Avail  ar'd/or 
!  Special 


Ifr 


i - 


•*ri 


PS  620143200 
1  November  1985 


PREFACE 


This  product  specification  covers  the  work  performed  under 
Air  Force  Contract  F33615-80-C-5155  ( ICAM  Project  6201).  This 
contract  is  sponsored  by  the  Materials  Laboratory,  Air  Force 
Systems  Command,  Wright-Patterson  Air  Force  Base.  Ohio.  It  was 
administered  under  the  technical  direction  of  Mr.  Gerald  C. 
Shumaker,  ICAM  Program  Manager ,  Manufacturing  Technology 
Division,  through  Project  Manager,  Mr.  David  Judson.  The  Prime 
Contractor  was  Production  Resources  Consulting  of  the  General 
Electric  Company,  Schenectady,  New  York,  under  the  direction  of 
Mr.  Alan  Rubenstein.  The  General  Electric  Project  Manager  was 
Mr.  Myron  Hurlbut  of  Industrial  Automation  Systems  Department, 
Albany,  New  York. 

Certain  work  aimed  at  improving  Test  Bed  Technology  has 
been  performed  by  other  contracts  with  Project  6201  performing 
integrating  functions.  This  work  consisted  of  enhancements  to 
Test  Bed  software  and  establishment  and  operation  of  Test  Bed 
hardware  and  communications  for  developers  and  other  users. 
Documentation  relating  to  the  Test  Bed  from  all  of  these 
contractors  and  projects  have  been  integrated  under  Project  6201 
for  publication  and  treatment  as  an  integrated  set  of  documents. 
The  particular  contributors  to  each  document  are  noted  on  the 
Report  Documentation  Page  (DD1473).  A  listing  and  description 
of  the  entire  project  documentation  system  and  how  they  are 
related  is  contained  in  document  FTR620100001 ,  Project  Overview. 

The  subcontractors  and  their  contributing  activities  were 
as  follows: 


TASK  4.2 

Subcontractors  Role 

Boeing  Military  Aircraft  Reviewer. 

Company  (BMAC) 

D.  Appleton  Company 
(DACOM) 


General  Dynamics/ 
Ft.  Worth 


Responsible  for  IDEF  support, 
state-of-the-art  literature 
search . 

Responsible  for  factory  view 
function  aijd  .-information 
models.  f‘l 
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Role 


Subcontractors 

Illinois  Institute  of 
Techno 1 ogy 

North  American  Rockwell 
Northrop  Corporation 

Pritsker  and  Associates 
SofTech 

TASKS  4.3  -  4.9  (TEST  BED) 

Subcontractors 

Boeing  Military  Aircraft 
Company  ( BMAC ) 

Computer  Technology 
Associates  (CTA) 

Control  Data  Corporation 
(CDC) 


D.  Appleton  Company 
CDACOM) 


Responsible  for  factory  view 
function  research  (IITRI) 
and  information  models  of 
small  and  medium- size  business. 


Responsible  for  factory  view 
function  and  information 
models . 

Responsible  for  IDEF2  support. 
Responsible  for  IDEFO  support. 


Assisted  in  the  areas  of 
communications  systems,  system 
design  and  integration 
methodology,  and  design  of  the 
Network  Transaction  Manager. 


Responsible  for  the  Common  Data 
Model  (CDM)  implementation  and 
part  of  the  CDM  design  (shared 
with  DACOM) . 

Responsible  for  the  overall  CDM 
Subsystem  design  integration 
and  test  plan,  as  well  as  part 
of  the  design  of  the  CDM 
(shared  with  CDC).  DACOM  also 
developed  the  Integration 
Methodology  and  did  the  schema 
mappings  for  the  Application 
Subsystems . 


Reviewer . 


Role 

Responsible  for  consultation  on 
applications  of  the  technology 
and  on  IBM  computer  technology. 
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Subcontractors 


Role 


Digital  Equipment 
Corporation  (DEC) 


McDonne 1 1  Doug las 
Automation  Company 
(McAuto) 


On-Line  Software 
International  (OSI) 


Consulting  and  support  of  the 
performance  testing  and  on  DEC 
software  and  computer  systems 
operation . 

Responsible  for  the  support  and 
enhancements  to  the  Network 
Transaction  Manager  Subsystem 
during  1984/1985  period. 

Responsible  for  programming  the 
Communications  Subsystem  on  the 
IBM  and  for  consulting  on  the 
IBM. 


Rath  and  Strong  Systems 
Products  (RSSP)  (In  1985 
became  McCormack  &  Dodge) 


SofTech,  Inc 


Software  Performance 
Engineering  (SPE) 


Structural  Dynamics 
Research  Corporation 
(SDRC) 


Responsible  for  assistance  in 
the  implementation  and  use  of 
the  MRP  II  package  (PIOS)  that 
they  supplied. 

Responsible  for  the  design  and 
implementation  of  the  Network 
Transaction  Manager  ( NTM )  in 
1981/1984  period. 

Responsible  for  directing  the 
work  on  performance  evaluation 
and  analysis. 

Responsible  for  the  User 
Interface  and  Virtual  Terminal 
Interface  Subsystems . 


Other  prime  contractors  under  other  projects  who  have 
contributed  to  Test  Bed  Technology,  their  contributing 
activities  and  responsible  projects  are  as  follows: 


Contractors 


ICAM  Project  Contributing  Activities 


Boeing  Military 
Aircraft  Company 
( BMAC ) 


1701,  2201, 
2202 


Enhancements  for  IBM 
node  use.  Technology 
Transfer  to  Integrated 
Sheet  Metal  Center 
( I SMC ) . 


>*> 
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Contractors 


ICAM  Project  Contributing  Activities 


Control  Data 
Corporation  (CDC) 


1502,  1701  IISS  enhancements  to 

Common  Data  Model 
Processor  (CDMP). 


D.  Appleton  Company  1502 

(DACOM) 

General  Electric  1502 

Hughes  Aircraft  1701 

Company  ( HAC ) 

Structural  Dynamics  1502 

Research  Corporation  1703 

(SDRC) 


IISS  enhancements  to 
Integration  Methodology. 

Operation  of  the  Test 
Bed  and  communications 
equipment . 

Test  Bed  enhancements . 


1701,  IISS  enhancements  to 

User  Interface/Virtual 
Terminal  Interface 
CUI/VTI) . 


Systran 


1502  Test  Bed  enhancements. 

Operation  of  Test  Bed. 
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SECTION  1 
SCOPE 


1 . 1  Identification 

This  specification  establishes  the  'as  built'  design  of  the 
Interprocess  Communication  Primitives  (IPC's). 

1 . 2  Functional  Summary 

The  IPC's  are  the  lowest  level  of  common  services  in  the 
IISS.  Their  function  is  to  supply  a  standard  interface  to 
operating  system  services  normally  required  by  complex 
application  systems.  The  implementation  of  these  routines, 
therefore,  is  highly  system  dependent. 

The  services  they  support  are  passing  messages  between  two 
programs,  starting  and  stoping  a  timer,  and  responding  to  a 
series  of  asynchronous  events. 
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SECTION  2 
DOCUMENTS 


2.1  Reference  Documents 


The  following  pertinent  reference  materials  are  available 
at  the  ICAM  Program  Office. 

1 .  Interim  Reports 

2.  Life  Cycle  Documents 

(a)  ITR620150002U  Project  Scope 

(b)  PMP620 150000  Master  Plan  and  Schedule 

(c)  SAD620 150000  State-of-the-art  Review 

(d)  SRD620 140000  System  Requirements  Document 

(e)  SDS620 140000  System  Design  Specifications 

(f)  DS6201430000  Development  Specification  - 

Commun i cat i ons  Subsystem 

The  following  reference  materials  are  available  from 
Digital  Equipment  Corporation. 

(a)  VAX/VMS  1/0  User's  Guide  (Volume  1),  Order  No. 
AA-M540B-TE 

(b)  VAX/VMS  1/0  User ' s  Guide  (Volume  2),  Order  No. 
AA-M541B-TE 

(c)  VAX  COBOL  Language  Reference  Manual .  Order  No. 
AA-H631C-TE 

(d)  VAX-1 1  FORTRAN  Language  Reference  Manual ,  Order 
No.  AA-D034C-TE 

2.2  Terms  and  Abbreviations 


All  the  arguments  for  the  IPC's  are  described  in  DS 
620140004  for  the  Communication  Subsystem;  however,  the  more 
important  ones  are  reiterated  here. 

1.  Input  Mai lbox  -  the  logical  name  for  a  section  of 
memory  from  which  a  primitive  obtains  a  message  that 
was  send  to  a  program 

2.  Target  Mai lbox  -  the  logical  name  for  a  section  of 
memory  into  which  a  primitive  stores  a  message 

3.  Event  Block  -  a  block  of  contiguous  memory,  local  to  a 
program,  into  which  primitives  store  system  dependent 
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SECTION  3 
REQUIREMENTS 


3 . 1  Structural  Descriptions 

The  description  of  each  IPC  along  with  its  calling 
sequence,  its  inputs  and  its  outputs  is  given  is  Sections  3.2.7 
and  3.5  of  the  Commun i cat i on  Subsystem  Development 
Specification.  DS620140004.  Thus,  only  a  list  of  the  IPC's  and 
their  functions  will  be  presented  here. 

3.1.1  Create  a  Mailbox 

The  routine  CRTMBX  creates  a  mailbox  (global  storage  in 
memory)  through  which  a  program  may  receive  messages  from 
another  program  executing  on  the  same  computer  at  the  same  time. 

3.1.2  Send  a  Message  to  Another  Program 

The  routine  SNDMSG  sends  a  message  to  another  program 
executing  on  the  same  computer  at  the  same  time  by  placing  it  in 
the  input  mailbox  (memory)  allocated  to  the  other  program. 

3.1.3  Receive  a  Message  from  Another  Program 

The  routine  RCVMSG  records  the  fact  that  the  program  will 
accept  messages  sent  from  other  programs  to  its  input  mailbox. 
The  routine  returns  to  the  program  allowing  it  to  execute  while 
other  programs  send  messages. 

3.1.4  Get  a  Message  from  Another  Program 

The  routine  GETMSG  removes  a  message  from  the  input 
mailbox  (memory)  of  a  program  and  moves  it  to  the  given  buffer. 

3.1.5  Delete  a  Mailbox 

The  routine  DELMBX  removes  the  capability  of  receiving 
messages  through  the  given  input  mailbox.  Whether  the  memory  is 
released  for  other  uses  at  this  time  depends  upon  the  computer 
and  operating  system  under  which  IISS  runs. 

3.1.6  Release  an  Event  Block 


The  routine  RELEVB  reinitializes  an  event  block  (local 
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program  storage)  enabling  it  to  be  used  with  other  primitives. 
It  is  needed  to  clear  an  event  block  when  the  same  event  block 
is  used  with  different  target  mailboxes. 

3.1.7  Start  a  Timer 


The  routine  SETTIM  invokes  a  timing  mechanism  that  will 
cause  an  event  when  the  time  interval  has  elapsed.  After  noting 
the  time,  the  routine  returns  to  the  program  allowing  it  to 
continue  executing. 

3.1.8  Stop  a  Timer 

The  routine  CNLTIM  terminates  the  timing  mechanism 
initiated  by  the  SETTIM  routine. 

3.1.9  Wait  for  an  Event  to  Occur 

The  routine  WAITnn  (where  nn  is  the  maximum  number  of 
events  possible)  waits  for  the  completion  of  one  of  the 
outstanding  requests  that  are  associated  with  the  list  of  event 
blocks.  The  program  is  suspended  until  an  event  occurs. 

3.1.10  Terminate  a  Run 

The  routine  ENDRUN  terminates  the  executing  of  the 
program . 

3 . 2  Functional  Flow  Description 

Since  the  implementation  of  the  IPC's  are  system 
dependent,  the  functional  flow  description  must  be  described  in 
context  of  the  computer  and  operating  system.  The  IPC's  were 
implemented  on  the  IBM  3084  under  CICS  and  under  MVS.  They  were 
implemented  on  the  Honeywell  Level  6  under  Mod  400  and  on  the 
VAX  under  VMS. 

3.3  Interfaces 


On  the  IBM,  under  CICS,  the  IPC's  were  implemented  using 
some  CICS  command  level  and  some  macro  level  system  interfaces. 
The  command  level  was  written  in  COBOL,  while  the  macro  level 
was  in  assembler.  This  mixed  mode  format  was  required  because 
not  all  the  necessary  functions  were  available  at  the  command 
level.  There  is  no  mailbox  facility  under  CICS,  so  the  concept 
of  mailbox  had  to  designed  and  implemented  from  scratch. 
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Under  MVS,  the  IPC's  were  implemented  in  assembler  as  one 
task  with  different  entry  points  for  each  routine.  Again,  there 
is  no  mailbox  facility  under  MVS.  The  design  developed  for  CICS 
was  reimplemented  for  MVS. 

On  the  Honeywell  Level  6,  the  IPC's  were  again  a  mixture 
of  COBOL  and  assembler  because  the  only  interface  into  the 
system  services  is  through  assembler.  The  Mod  400  operating 
system  supports  a  mailbox  facility  so  calls  to  it  were  used  in 
the  implementation  of  the  IPC's. 

The  VAX  also  has  a  mailbox  facility  and  its  system 
services  are  accessible  through  high  level  languages. 

Therefore,  the  IPC's  on  the  VAX  were  implemented  using  a 
conbination  of  COBOL  and  FORTRAN. 

3 . 4  Interrupts 

This  section  does  not  apply  to  the  IPS's. 

3 . 5  Timing  and  Sequence  Description 

Timing  and  sequencing  is  only  relevant  to  the  Wait  for  an 
Event  to  Occur  primitive,  and  then  only  when  it  is  waiting  on 
more  than  one  event.  If  more  than  one  event  has  occurred,  the 
primitive  will  report  to  the  program  the  one  that  has  the 
highest  priority  based  on  event  number. 

3.6  Special  Control  Features 

The  Interprocess  Communication  Primitives  do  not  include 
any  special  control  features  as  defined  in  the  ICAM 
Documentations  Standards. 

3.7  Storage  Allocation 

3.7.1  Data  Base  Definition 

3. 7. 1.1  File  Description 

The  IPC's  do  not  use  any  files. 

3. 7. 1.2  Table  Description 

The  IPC's  do  not  use  any  tables. 
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3. 7. 1.3  Item  and  Constant  Description 


The  event  block  contains  two  variables  that  are  common 
across  all  implementations.  The  first  is  the  event  type  which 
indicates  whether  the  block  is  being  used  by  an  IPC  receive 
message,  a  timer,  or  a  receive  for  the  Communications  Subsystem. 
The  second  variable  indicates  the  possible  states  of  the 
event --no  event  outstanding,  event  outstanding  but  not 
completed,  event  completed  but  not  requested  by  the  program. 


3.7.2  CPC  Relationshi] 


The  event  block  is  used  with  every  IPC  except  ENDRUN  and 
LOCKEF . 


3.8  Object  Code  Creation 


To  create  the  IPC's  for  the  CICS  environment  requires  the 
CICS  preprocessor,  the  COBOL  compiler,  the  Assembler  and  the 
standard  link  editor  to  create  a  load  module  that  can  be 
referenced  when  linking  main  modules.  Except  for  the  CICS 
preprocessor,  the  same  mechanism  applies  for  creating  the  IPC 
load  library  under  MVS. 


To  create  the  IPC  library  on  the  Honeywell  Level  6 
requires  the  COBOL  compiler,  the  Assembler  and  the  standard 
1  inker . 


To  create  the  IPC  library  on  the  VAX  requires  the  COBOL 
and  FORTRAN  compilers  and  the  standard  linker. 


3.9  Adaption  Data 


The  IPC's  are  system  dependent;  therefore,  they  must  be 
reimplemented  for  each  computer  and/or  operating  system. 


3.10  Detail  Design  Description 


Main  Program  List 


The  following  is  a  list  of  all  "Main  Programs”  which 
are  modules  that  are  not  called  by  any  other  module  being 
documented  here.  These  modules  are  either  program  entry  points 
or.  if  they  are  hooked  into  another  set  of  programs  via 


subroutine  calls,  they  are  the  points  the  external  programs  can 
call  and  therefore  enter  through.  To  differentiate  between  the 
two  types  of  entry  points,  look  at  the  individual  Module 
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Documentation  (section  3.10.8)  and  look  at  Module  Type  for  each 
of  the  Main  Program  modules  listed.  Note  whether  the  routine 
is  a  Program,  Subroutine,  or  Function.  If  it  is  a  Program,  it 
is  truly  a  main  program  entry  point.  If  not,  then  it  is  merely 
called  by  other  programs  not  being  documented  here. 
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Module 

CNLTIM 

CRTMBX 

DELMBX 

ENDRUN 

GETMSG 

LOCKEF 

RCVMSG 

RELEVB 

SETTIM 

SNDMSG 

WAIT01 

WAIT02 

WAIT03 


IPC  Main  Program  List 
Name  Purpose 

CANCEL  A  TIMER 
CREATE  A  MAILBOX 
DELETE  A  MAILBOX 
STOP  THE  PROGRAM 

GET  A  MESSAGE  FROM  ANOTHER  PROGRAM 
LOCK  EVENT  FLAG 

RECEIVE  A  MESSAGE  FROM  ANOTHER  PROGRAM 

RELEASE  A  TARGET  EVENT  BLOCK  (CLEAR  IT) 
AND 

START  A  TIMER 

SEND  A  MESSAGE  TO  ANOTHER  PROGRAM 
WAIT  FOR  AN  EVENT  TO  OCCUR 
WAIT  FOR  AN  EVENT  TO  OCCUR 
WAIT  FOR  AN  EVENT  TO  OCCUR 
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3.10.2  Module  List 

The  following  is  a  list  of  all  the  modules  being 
documented  here  along  with  their  purpose.  Each  module  has  a 
unique  name,  no  matter  what  language  it  was  written  in. 
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Module 

CNLTIM 

CNLTMR 

CRTMBX 

DELMBX 

ENDRUN 

ERRFTL 

ERRPRO 

FREVTF 

GETMSG 

GETPNM 

LOCKEF 

RCVMSG 

RDMALF 

RELEVB 

SASGCH 

SCRTMB 

SDEACH 

SDELMB 

SETTIM 

SETTMR 


1PC  Module  List 
Name  Purpose 

CANCEL  A  TIMER 
CANCEL  THE  TIMER 
CREATE  A  MAILBOX 
DELETE  A  MAILBOX 
STOP  THE  PROGRAM 
PROCESS  FATAL  ERROR 
PROCESS  ERROR 
FREE  THE  EVENT  FLAG 
GET  A  MESSAGE  FROM  ANOTHER  PROGRAM 
GET  PROCESS  NAME 
LOCK  EVENT  FLAG 

RECEIVE  A  MESSAGE  FROM  ANOTHER  PROGRAM 

READ  THE  MAILBOX  FOR  EVENT  FLAG  SET 

RELEASE  A  TARGET  EVENT  BLOCK  (CLEAR  IT) 
AND 

ASSIGN  A  CHANNEL  TO  A  MAILBOX 
CREATE  A  MAILBOX 

DEASSIGN  CHANNEL  FROM  THE  MAILBOX 
DELETE  THE  MAILBOX 
START  A  TIMER 
SET  A  TIMER 
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Module 

SNDMSG 

SWEVTF 

VALMBE 

WAIT01 

WAIT02 

WAIT03 

WRTERR 

WRTMAI 


IPC  Module  List 
NaLme  Purpose 

SEND  A  MESSAGE  TO  ANOTHER  PROGRAM 
WAIT  FOR  ONE  OF  POSSIBLY  MANY  EVENTS 
VALIDATE  THAT  MAILBOX  ALREADY  EXISTS 
WAIT  FOR  AN  EVENT  TO  OCCUR 
WAIT  FOR  AN  EVENT  TO  OCCUR 
WAIT  FOR  AN  EVENT  TO  OCCUR 
WRITE  MESSAGE  TO  MAILBOX 
WRITE  THE  MESSAGE  INTO  THE  MAILBOX 
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3.10.3  External  Routines  List 

The  following  is  a  list  of  all  routines  or  functions  not 
documented  here  that  are  called  by  modules  that  are  documented 
here.  The  first  caller,  in  alphabetical  order,  is  listed  as 
well.  The  specification  in  which  any  module  is  documented  may 
be  found  in  the  Module  Documentation  Index  (Document  Number 
CM  620100001).  See  section  3.10.6  for  a  list  of  the  modules 
that  call  each  of  these  external  routines. 
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1PC  External  Routines  List 


Module  Name 

First  User 

LIBSFREE  EF 

SWEVTF 

LIBJGET  EF 

WRTERR 

SYSSASSIGN 

SASGCH 

SYSJBINTIM 

WRTERR 

SYSSCANTIM 

CNLTMR 

SYSSCLREF 

SWEVTF 

SYSSCREMBX 

SCRTMB 

SYSSDASSGN 

WRTERR 

SYSSDELMBX 

SDELMB 

SYSSGETDEV 

VALMBE 

SYSSGETJPI 

GETPNM 

SYSSQIO 

RDMALF 

SYSSQIOW 

WRTERR 

SYSSSETIMR 

SETTMR 

SYSSSETRWM 

SCRTMB 

SYSSWAITFR 

WRTERR 

SYS$WFLOR 

SWEVTF 
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3.10.4  Include  File  List 

The  following  is  a  list  of  all  include  files  called  in 
by  modules  being  documented  here.  Each  include  file  has  a 
unique  name  regardless  of  the  language  being  used.  The  purpose 
of  each  include  file  is  listed  as  well.  A  more  complete 
description  of  each  include  file  is  given  in  section  3.10.9. 

The  purpose  listed  is  the  one  that  is  in  the  source  code  of  the 
i nc 1 ude  file. 

A  purpose  of  "***»  PURPOSE  NOT  FOUND  BY  STRIPPER  **»*" 
indicates  that  a  purpose  statement  was  not  written  into  the 
include  file  itself.  The  most  common  reason  for  this  is  that 
the  include  file  comes  from  system  libraries  that  were  not 
developed  by  the  project,  such  as  'C'  libraries  that  are 
provided  with  the  'C'  compiler. 

See  section  3.10.6  for  a  set  of  lists  which  show  all 
the  modules  which  call  in  each  of  these  include  files. 
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I PC  Include  File  List 


File  Name 


Purpose 


( SJPIDEF) 

CHKSTS 

ERRPRO 

ERRSTS 

ERRSTS . INF 

KIPC 

MBEB01 

MBEB02 

MBEB03 

MBXEBK 

TIMREB 


****  PURPOSE  NOT  FOUND  BY  STRIPPER  »*** 

CHKSTS. INC  —  CHECK  STATUS 

PROCESS  ERROR  INCLUDE  FILE 

ERRSTS. INC  --  IISS  ERROR  CODES 

****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

KIPC. INC  --  CONSTAND  BLOCK  FOR  IPC  PRIMITIVES 
MBEB01 . INC  --  MAILBOX  EVENT  BLOCK  DESCRIPTION 
MBEB02 . INC  --  MAILBOX  EVENT  BLOCK  DESCRIPTION 
MBEB03 . INC  --  MAILBOX  EVENT  BLOCK  DESCRIPTION 
MBXEBK. INC  --  MAILBOX  EVENT  BLOCK  DESCRIPTION 
TIMREB. INC  --  TIME  EVENT  BLOCK  DESCRIPTION 


twl 

% 

f 

I 

>**!i 
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3.10 


Where  Include  File  Used  List 


The  following  lists  each  include  file  from  3.10.4  and 
all  the  modules  documented  in  this  specification  which  include 
them.  The  purpose  of  each  module  is  listed  as  well. 
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H1 

««5 

IPC  Where- include- 

* 

file-used  List 

Include  Module 

Module 

.* 

File  Nane 

Purpose 

••1 

C  $ JPIDEF) 

' 

GETPNM 

GET  PROCESS  NAME 

CHKSTS 

> 

CNLTIM 

CANCEL  A  TIMER 

CRTMBX 

CREATE  A  MAILBOX 

DELMBX 

DELETE  A  MAILBOX 

i 

ERRFTL 

PROCESS  FATAL  ERROR 

ERRPRO 

PROCESS  ERROR 

$ 

GETMSG 

GET  A  MESSAGE  FROM  ANOTHER  PROGRAM 

>» 

RCVMSG 

RECEIVE  A  MESSAGE  FROM  ANOTHER  PROGRAM 

RELEVB 

RELEASE  A  TARGET  EVENT  BLOCK  (CLEAR  IT) 

• 

*& 

SETTIM 

AND 

START  A  TIMER 

s 

SNDMSG 

SEND  A  MESSAGE  TO  ANOTHER  PROGRAM 

WAITOl 

WAIT  FOR  AN  EVENT  TO  OCCUR 

WAIT02 

WAIT  FOR  AN  EVENT  TO  OCCUR 

\  ‘i* 

WAIT03 

WAIT  FOR  AN  EVENT  TO  OCCUR 

■!; 

•i] 

ERRPRO 

CNLTIM 

CANCEL  A  TIMER 

■;• 

:*» 

CRTMBX 

CREATE  A  MAILBOX 

DELMBX 

DELETE  A  MAILBOX 

,*l 

GETMSG 

GET  A  MESSAGE  FROM  ANOTHER  PROGRAM 

;*t 

RCVMSG 

RECEIVE  A  MESSAGE  FROM  ANOTHER  PROGRAM 

St 

RELEVB 

RELEASE  A  TARGET  EVENT  BLOCK  (CLEAR  IT) 

—*■ 

AND 

X 

V 

SETTIM 

START  A  TIMER 

SNDMSG 

SEND  A  MESSAGE  TO  ANOTHER  PROGRAM 

WAITOl 

WAIT  FOR  AN  EVENT  TO  OCCUR 

V 1 

WAIT02 

WAIT  FOR  AN  EVENT  TO  OCCUR 

WAIT03 

WAIT  FOR  AN  EVENT  TO  OCCUR 

% 

\ 
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IPC  Where-include-f i le-used  List 

Include  Module  Module 

File  Name  Purpose 


ERRSTS 

CNLTIM 

CRTMBX 

DELMBX 

GETMSG 

RCVMSG 

RELEVB 

SETTIM 

SNDMSG 

WAIT01 

WAIT02 

WAIT03 


CANCEL  A  TIMER 
CREATE  A  MAILBOX 
DELETE  A  MAILBOX 

GET  A  MESSAGE  FROM  ANOTHER  PROGRAM 
RECEIVE  A  MESSAGE  FROM  ANOTHER  PROGRAM 
RELEASE  A  TARGET  EVENT  BLOCK  (CLEAR  IT) 
AND 

START  A  TIMER 

SEND  A  MESSAGE  TO  ANOTHER  PROGRAM 
WAIT  FOR  AN  EVENT  TO  OCCUR 
WAIT  FOR  AN  EVENT  TO  OCCUR 
WAIT  FOR  AN  EVENT  TO  OCCUR 


ERRSTS . INF 

CNLTMR  CANCEL  THE  TIMER 

GETPNM  GET  PROCESS  NAME 

LOCKEF  LOCK  EVENT  FLAG 

RDMALF  READ  THE  MAILBOX  FOR  EVENT  FLAG  SET 

SASGCH  ASSIGN  A  CHANNEL  TO  A  MAILBOX 

SCRTMB  CREATE  A  MAILBOX 

SDEACH  DEASSIGN  CHANNEL  FROM  THE  MAILBOX 
SDELMB  DELETE  THE  MAILBOX 

SETTMR  SET  A  TIMER 

VALMBE  VALIDATE  THAT  MAILBOX  ALREADY  EXISTS 

WRTERR  WRITE  MESSAGE  TO  MAILBOX 

WRTMAI  WRITE  THE  MESSAGE  INTO  THE  MAILBOX 
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IPC  Where-include-f i le-used  List 

Include  Module  Module 

File  Name  Purpose 


KIPC 

CRTMBX  CREATE  A  MAILBOX 

GETMSG  GET  A  MESSAGE  FROM  ANOTHER  PROGRAM 
RCVMSG  RECEIVE  A  MESSAGE  FROM  ANOTHER  PROGRAM 
SNDMSG  SEND  A  MESSAGE  TO  ANOTHER  PROGRAM 


MBEBOl 

WAITOl  WAIT  FOR  AN  EVENT  TO  OCCUR 
WAIT02  WAIT  FOR  AN  EVENT  TO  OCCUR 
WAIT03  WAIT  FOR  AN  EVENT  TO  OCCUR 


MBEB02 

WAIT02  WAIT  FOR  AN  EVENT  TO  OCCUR 
WAIT03  WAIT  FOR  AN  EVENT  TO  OCCUR 


MBEB03 

WAIT03  WAIT  FOR  AN  EVENT  TO  OCCUR 


MBXEBK 

CRTMBX  CREATE  A  MAILBOX 

DELMBX  DELETE  A  MAILBOX 

GETMSG  GET  A  MESSAGE  FROM  ANOTHER  PROGRAM 

RCVMSG  RECEIVE  A  MESSAGE  FROM  ANOTHER  PROGRAM 

RELEVB  RELEASE  A  TARGET  EVENT  BLOCK  (CLEAR  IT) 

AND 

SNDMSG  SEND  A  MESSAGE  TO  ANOTHER  PROGRAM 
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IPC  Where-include-f i le-used  List 


Include  Module 
File  Name 


Module 

Purpose 
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3.10.6  Where  External  Routine  Used  List 

The  following  lists  each  external  function  or  routine 
listed  in  3.10.3  and  all  the  documented  modules  which  call  it. 
The  purpose  of  each  module  is  listed  as  well. 
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IPC  Where-external -routine-used  List 


System  Module 
Module  Name 


LIBSFREE  EF 

FREVTF 

SWEVTF 

WRTERR 


LIB$GET  EF 

LOCKEF 

RDMALF 

SETTMR 

WRTERR 


SYSSASSIGN 

SASGCH 

WRTERR 


SYSJBINTIM 

SETTMR 

WRTERR 


SYSJCANTIM 

CNLTMR 


SWEVTF 


Module 

Purpose 


FREE  THE  EVENT  FLAG 

WAIT  FOR  ONE  OF  POSSIBLY  MANY  EVENTS 
WRITE  MESSAGE  TO  MAILBOX 


LOCK  EVENT  FLAG 

READ  THE  MAILBOX  FOR  EVENT  FLAG  SET 
SET  A  TIMER 

WRITE  MESSAGE  TO  MAILBOX 


ASSIGN  A  CHANNEL  TO  A  MAILBOX 
WRITE  MESSAGE  TO  MAILBOX 


SET  A  TIMER 

WRITE  MESSAGE  TO  MAILBOX 


CANCEL  THE  TIMER 


WAIT  FOR  ONE  OF  POSSIBLY  MANY  EVENTS 
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IPC  Where-external -routine-used  List 

System  Module  Module 

Module  Name  Purpose 


SYSSCREMBX 

SCRTMB  CREATE  A  MAILBOX 


SYSSDASSGN 

SDEACH  DEASSIGN  CHANNEL  FROM  THE  MAILBOX 

WRTERR  WRITE  MESSAGE  TO  MAILBOX 


SYSSDELMBX 

SDELMB  DELETE  THE  MAILBOX 


SYSSGETDEV 

VALMBE  VALIDATE  THAT  MAILBOX  ALREADY  EXISTS 


SYSJGETJPI 

GETPNM  GET  PROCESS  NAME 


SYSSQIO 

RDMALF  READ  THE  MAILBOX  FOR  EVENT  FLAG  SET 


SYSJQIOW 

WRTERR  WRITE  MESSAGE  TO  MAILBOX 

WRTMAI  WRITE  THE  MESSAGE  INTO  THE  MAILBOX 
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IPC  Where-external-routine-used  List 

System  Module  Module 

Module  Name  Purpose 


SYSJSETIMR 

SETTMR  SET  A  TIMER 

WRTERR  WRITE  MESSAGE  TO  MAILBOX 


SYSSSETRWM 

SCRTMB  CREATE  A  MAILBOX 


SYSSWAITFR 

WRTERR  WRITE  MESSAGE  TO  MAILBOX 


SYSSWFLOR 

SWEVTF  WAIT  FOR  ONE  OF  POSSIBLY  MANY  EVENTS 
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3.10.7  Main  Program  Parts  List 

The  following  lists  each  Main  Program  listed  in  3.10.1 
and  all  the  modules  which  are  called  either  by  that  module 
itself  or  by  any  of  the  documented  modules  which  it  calls.  It 
is  possible  for  a  non-main  module  to  be  listed  more  that  once 
if  it  is  called  by  multiple  modules.  The  called  modules,  in 
this  case  known  as  program  parts,  are  marked  as  to  whether 
they  are  documented  here.  If  so,  the  phrase  "well-defined 
module"  appears  by  the  module  name,  if  not  it  is  an  "external 
“routine".  The  Purpose  of  the  Main  Program  module  is  listed 
as  wel 1 . 
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IPC  Main  Program  Parts  List 


Main  Pgm 

Module 

Module 

Name 

Name 

Type 

CNLTIM 

Purpose-- 

> CANCEL  A  TIMER 

CNLTMR 

Well-defined  module 

ERRFTL 

Well-defined  module 

ERRPRO 

Well-defined  module 

FREVTF 

Well-defined  module 

GETPNM 

Well-defined  module 

LIBSFREE  EF 

External  routine 

L1BSGET  EF 

External  routine 

SYSSASSIGN 

External  routine 

SYSSBINTIM 

External  routine 

SYSSCANTIM 

External  routine 

SYS JDASSGN 

External  routine 

SYSSGETJPI 

External  routine 

SYSJQIOW 

External  routine 

SYSSSETIMR 

External  routine 

SYSSWAITFR 

External  routine 

WRTERR 

Well-defined  module 
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IPC  Main  Program  Parts  List 


Main  Pgm 

Module 

Module 

Name 

Name 

Type 

CRTMBX 

Purpose-- 

> CREATE  A 

MAILBOX 

ERRFTL 

Well-defined  module 

ERRPRO 

Well-defined  module 

GETPNM 

Well-defined  module 

LIBSFREE  EF 

External 

routine 

LIBJGET  EF 

External 

routine 

SCRTMB 

Well -def 

ined  module 

SYSSASSIGN 

External 

routine 

SYSSBINTIM 

External 

routine 

SYSSCREMBX 

External 

routine 

SYSSDASSGN 

External 

routine 

SYSSGETDEV 

External 

routine 

SYSSGETJPI 

External 

routine 

SYSJQ10W 

External 

routine 

SYSSSETIMR 

External 

routine 

SYSSSETRWM 

External 

routine 

SYSSWAITFR 

External 

routine 

VALMBE 

Well-defined  module 

WRTERR 

Well-defined  module 
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IPC  Main  Program  Parts  List 


Main  Pgm  Module 
Name  Name 


DELMBX 


Purpose- 

ERRFTL 

ERRPRO 

GETPNM 

LIBJFREE  EF 

LIBSGET  EF 

SDEACH 

SDELMB 

SYSSASSIGN 

SYSSBINTIM 

SYSSDASSGN 

SYS S DELMBX 

SYSSGETJPI 

SYSJQIOW 

SYSSSETIMR 

SYSSWAITFR 

WRTERR 


Module 

Type 


-> DELETE  A  MAILBOX 
Well-defined  module 
Well-defined  module 
Well-defined  module 
External  routine 
External  routine 
Well-defined  module 
Well-defined  module 
External  routine 


External 

External 

External 

External 

External 

External 

External 


routine 

routine 

routine 

routine 

routine 

routine 

routine 


Well-defined  module 


WWW 


3-26 


PS  620143200 
1  November  1985 


IPC  Main  Program  Parts  List 

Main  Pgm  Module  Module 

Name  Name  Type 


GETMSG  Purpose- 

ERRFTL 

ERRPRO 

FREVTF 

GETPNM 

LIBSFREEEF 

LIBSGETEF 

SYSS ASSIGN 

SYSSBINTIM 

SYSS DAS SGN 

SYSSGETJPI 

SYSSQIOW 

SYSSSETIMR 

SYSSWAITFR 

WRTERR 


>  GET  A  MESSAGE  FROM  ANOTHER 
PROGRAM 

Well-defined  module 
Well-defined  module 
Well-defined  module 
Well-defined  module 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
Well-defined  module 


* 
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i 

‘  * 

IPC  Main  Program  Parts 

List 

Main  Pgm  Module 

Module 

'J 

Name  Name 

Type 

{% 
.  J 

LOCKEF  Purpose 

-- >LOCK  EVENT  FLAG 

ERRFTL 

Well-defined  module 

ERRPRO 

Well-defined  module 

;// 

GETPNM 

Well-defined  module 

LIBS FREE  EF 

External  routine 

.♦ 

LIBSGET  EF 

External  routine 

tf 

SYSSASSIGN 

External  routine 

** 

SYSSBINTIM 

External  routine 

SYSSDASSGN 

External  routine 

SYSSGETJPI 

External  routine 

3 

SYSSQIOW 

External  routine 

5! 

SYSSSETIMR 

External  routine 

•|* 

*«< 

* 

•r 

</ 

1 

!* 

f 

SYSJWAITFR 

External  routine 

WRTERR 

Well-defined  module 

l 

y 

v 

! 

**, 

• 

»* 

■«»! 

4*i 
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IPC  Main  Program  Parts  List 


Main  Pgm 

Module 

Module 

Name 

Name 

Type 

RCVMSG 

Purpose — 

.RECEIVE  A  MESSAGE  FROM  ANOTHER 
PROGRAM 

ERRFTL 

Well-defined  module 

ERRPRO 

Well-defined  module 

GETPNM 

Well-defined  module 

LIBSFREE  EF 

External  routine 

LIBS GET  EF 

External  routine 

RDMALF 

Well-defined  module 

SYSSASSIGN 

External  routine 

SYSSBINTIM 

External  routine 

SYSSDASSGN 

External  routine 

SYSSGETJPI 

External  routine 

SYSSQIO 

External  routine 

SYSSQIOW 

External  routine 

SYSSSETIMR 

External  routine 

SYSSWAITFR 

External  routine 

WRTERR 

Well-defined  module 
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IPC  Main  Program  Parts  List 

Main  Pgm  Module  Module 

Name  Name  Type 


Purpose-- > RELEASE  A  TARGET  EVENT  BLOCK 
(CLEAR  IT)  AND 


RELEVB 

ERRFTL 
ERRPRO 
GETPNM 
LIBJFREE  EF 
LIBSGET  EF 
SDEACH 
SYSSASSIGN 
SYSSBINTIM 
SYSSDASSGN 
SYSSGETJPI 
SYSSQIOW 
SYSSSETIMR 
SYSSWAITFR 
WRTERR 


Well-defined  module 
Well-defined  module 
Well-defined  module 
External  routine 
External  routine 
Well-defined  module 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
Well-defined  module 


m 
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I PC  Main  Program  Parts  List 

Main  Pgm  Module  Module 

Name  Name  Type 


SETTIM 

ERRFTL 
ERRPRO 
GETPNM 
LIB$FREE_EF 
LIBSGETEF 
SETTMR 
SYSSASSIGN 
SYSSBINTIM 
SYSSDASSGN 
SYS$GETJPI 
SYSSQIOW 
SYSSSETIMR 
SYSSWAITFR 
WRTERR 


Well-defined  module 
Well-defined  module 
Well -def i ned  modu 1 e 
External  routine 
External  routine 
Well-defined  module 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
Well-defined  module 


Purpose-- > START  A  TIMER 
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IPC  Main  Program  Parts  List 


Main  Pgm 

Module 

Module 

Name 

Name 

Type 

SNDMSG 

Purpose-- 

>  SEND  A  MESSAGE  TO  ANOTHER 
PROGRAM 

ERRFTL 

Well-defined  module 

ERRPRO 

Well-defined  module 

GETPNM 

Well-defined  module 

LIBSFREE  EF 

External  routine 

LIBSGET  EF 

External  routine 

SASGCH 

Well-defined  module 

SYSSASSIGN 

External  routine 

SYSSBINTIM 

External  routine 

SYSJDASSGN 

External  routine 

SYSSGETJPI 

External  routine 

SYSSQIOW 

External  routine 

SYSSSETIMR 

External  routine 

SYSSWAITFR 

External  routine 

WRTERR 

Well-defined  module 

WRTMAI 

Well-defined  module 
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IPC  Main  Program  Parts  List 


Main  Pgm 

Module 

Module 

Name 

Name 

Type 

WAIT01 

Purpose-- 

>  WAIT  FOR  AN  EVENT  TO  OCCUR 

ERRFTL 

Well-defined  module 

ERRPRO 

Well-defined  module 

GETPNM 

Well-defined  module 

LIBSFREE  EF 

External  routine 

LIBSGET  EF 

External  routine 

SWEVTF 

Well-defined  module 

SYS$ ASSIGN 

External  routine 

SYSSBINTIM 

External  routine 

SYSSCLREF 

External  routine 

SYSSDASSGN 

External  routine 

SYSSGETJPI 

External  routine 

SYSSQIOW 

External  routine 

SYSSSETIMR 

External  routine 

SYSSWAITFR 

External  routine 

SYSSWFLOR 

External  routine 

WRTERR 

Well-defined  module 

PS  620143200 
1  November  1985 


IPC  Main  Program  Parts  List 


Main  Pgm 

Module 

Module 

Name 

Name 

Type 

WAIT02 

Purpose — 

>  WAIT  FOR  AN  EVENT  TO  OCCUR 

ERRFTL 

Well-defined  module 

ERRPRO 

Well -def i ned  modu 1 e 

GETPNM 

Well-defined  module 

LIBSFREE  EF 

External  routine 

LIBSGET  EF 

External  routine 

SWEVTF 

Well-defined  module 

SYSS ASSIGN 

External  routine 

SYSSBINTIM 

External  routine 

SYSSCLREF 

External  routine 

SYS JDASSGN 

External  routine 

SYSSGETJPI 

External  routine 

SYSSQIOW 

External  routine 

SYSSSETIMR 

External  routine 

SYSSWAITFR 

External  routine 

SYSSWFLOR 

External  routine 

WRTERR 

Well-defined  module 
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IPC  Main  Program  Parts  List 


Main  Pgm 

Module 

Module 

Name 

Name 

Type 

WAIT03 

Purpose — 

.WAIT  FOR 

AN  EVENT  TO  OCCUR 

ERRFTL 

Well-defined  module 

ERR PRO 

Well-defined  module 

GETPNM 

Well-defined  module 

LIBSFREE  EF 

External 

routine 

L1BSGET  EF 

External 

routine 

SWEVTF 

Well-defined  module 

SYSSASSIGN 

External 

routine 

SYSJBINTIM 

External 

routine 

SYSSCLREF 

External 

routine 

SYSSDASSGN 

External 

routine 

SYSSGETJPI 

External 

routine 

SYSSQIOW 

External 

routine 

SYSSSETIMR 

External 

routine 

SYSSWAITFR 

External 

routine 

SYSSWFLOR 

External 

routine 

WRTERR 

Well -def i ned  modu 1 e 
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3.10.8  Module  Documentation 

The  following  documentation  describes  information 
which  is  specific  to  each  individual  module  being  documented 
in  this  specification  as  listed  in  section  3.10.2.  It 
provides  a  compact  way  of  getting  information  that  would  be 
otherwise  buried  within  each  module's  source  code. 

The  specific  items  in  this  module  documentation  have  the 
following  meanings: 

NAME:  Name  of  program  Module. 

PURPOSE:  Purpose  of  Module  as  detailed  in  the 

source  code. 

LANGUAGE:  Programming  language  source  code  is 

written  in. 

The  choices  are: 

VAX- 11  FORTRAN 

C  (I/S-l  Workbench  C) 

VAX- 11  COBOL 

MODULE  TYPE:  Whether  a  Program,  Subroutine,  or 

Funct i on . 

SOURCE  FILE:  Name  of  Source  File  from  file 

specification. 

SOURCE  FILE  TYPE:  Source  File  Extension  from  file 

specification. 

HOST:  Whether  this  is  a  host -dependent 

routine  (VAX  or  IBM)  or  blank  if 
host- independent . 

SUBSYSTEM:  IISS  sub-system  this  file  resides  in. 

SUBDIRECTORY:  Sub-directory  of  that  subsystem  in 

which  this  file  resides. 

DOCUMENTATION  GROUP:  Name  of  documentation  group  of  which 

this  source  file  is  a  member. 


DESCRIPTION : 


A  description  of  the  module  as  otained 
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from  the  source  code. 


ARGUMENTS : 

INCLUDE  FILES: 

I 

i 

\ 


The  arguments  with  which  this  routine 
is  called  if  it  is  a  Subroutine  or  a 
Function . 

A  list  of  all  the  files  that  are 
included  into  this  module  as  well  as 
their  purposes. 


ROUTINES  CALLED:  Subroutines  or  Functions,  either 

documented  or  external,  called  by 
this  module,  if  any. 


CALLED  DIRECTLY  BY:  The  documented  routines  which  call 

this  module,  if  any. 

USED  IN  MAIN  PROGRAM ( S ) :  The  documented  Main  Programs  which 

contain  this  module  in  their  parts 
list  according  to  the  list  in  section 
3.10.7. 


The  Module  Documentation  is  arranged  alphabetical ly  according 
to  Module  Name. 
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IPC  Module  Documentation 


NAME : 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP 

DESCRIPTION: 


CNLTIM 

CANCEL  A  TIMER 

VAX- 11  COBOL 

SUBROUTINE 

CNLTIM 

.COB 

VAX 

IPC 

:  IPC 


CANCEL  A  RUNNING  TIMER 


ARGUMENTS : 


TIMER-EVENT-BLOCK  -  RECRD 
RET-STATUS  =  DSPLY  [X(5)] 


INCLUDE  FILES: 


CHKSTS 

ERRSTS 

TIMREB 

ERRPRO 


CHKSTS. INC  —  CHECK  STATUS 

ERRSTS. INC  --  IISS  ERROR  CODES 

TIMREB. INC  --  TIME  EVENT  BLOCK  DESCRIPTION 

PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


FREVTF  -  FREE  THE  EVENT  FLAG 

CNLTMR  -  CANCEL  THE  TIMER 

ERRPRO  -  PROCESS  ERROR 
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IPC  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 

HOST: 

SUBSYSTEM : 

SUBDIRECTORY : 

DOCUMENTATION  GROUP 

DESCRIPTION: 

i  - 

CANCEL  IISS  TIMER 
REQUEST  IDENTIFICATION  IS  4 


ARGUMENTS : 


RSTATS  =  CHAR 

-  RETURN  STATUS 


CNLTMR 

CANCEL  THE  TIMER 

VAX- 11  FORTRAN 

SUBROUTINE 

CNLTMR 

.FOR 

VAX 

IPC 

IPC 


INCLUDE  FILES: 

ERRSTS  .  INF  -  "**  PURPOSE  NOT  FOUND  BY  STRIPPER  ***• 

ROUTINES  CALLED 

ERRPRO  -  PROCESS  ERROR 

SYSSCANTIM 

CALLED  DIRECTLY  BY: 

CNLTIM  -  CANCEL  A  TIMER 

USED  IN  MAIN  PROGRAM ( S  ) 

CNLTIM  -  CANCEL  A  TIMER 
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I PC  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY: 
DOCUMENTATION  GROUP 


CRTMBX 

CREATE  A  MAILBOX 

VAX- 11  COBOL 

SUBROUTINE 

CRTMBX 

.COB 

VAX 

I  PC 

I  PC 


DESCRIPTION : 


IT  CREATES  A  MAILBOX  THROUGH  WHICH  THE 
PROGRAM  WILL  RECEIVE  MESSAGES  FROM  ANOTHER 
PROGRAM  RUNNING  ON  THE  SAME  COMPUTER. 


ARGUMENTS : 


INPUT-MAILBOX-NAME  =  DSPLY  [X(14)3 
MAILBOX-SIZE  >  DSPLY  [9(5)3 
MAILBOX -EVENT- BLOCK  =  RECRD 
RET-STATUS  «  DSPLY  [X(5)3 


INCLUDE  FILES: 


CHKSTS 

ERRSTS 

KIPC 

MBXEBK 

ERRPRO 


CHKSTS. INC  --  CHECK  STATUS 

ERRSTS. INC  --  IISS  ERROR  CODES 

KIPC. INC  --  CONSTAND  BLOCK  FOR  IPC  PRIMITIVES 

MBXEBK. INC  --  MAILBOX  EVENT  BLOCK  DESCRIPTION 

PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


VALMBE  -  VALIDATE  THAT  MAILBOX  ALREADY  EXISTS 

SCRTMB  -  CREATE  A  MAILBOX 

ERRPRO  -  PROCESS  ERROR 
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IPC  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP 


DELMBX 

DELETE  A  MAILBOX 

VAX- 11  COBOL 

SUBROUTINE 

DELMBX 

-COB 

VAX 

IPC 

IPC 


DESCRIPTION: 


-  IT  DELETES  A  MAILBOX  WHEREBY  REMOVING 
THE  ABILITY  TO  RECEIVE  MESSAGES  FROM  ANOTHER 
PROGRAM  THROUGH  THE  GIVEN  INPUT  MAILBOX 


ARGUMENTS : 


INPUT-MAILBOX-NAME  «  DSPLY  [X(14)] 
MAILBOX-EVENT-BLOCK  •=  RECRD 
RET-STATUS  =  DSPLY  [X(5)] 


INCLUDE  FILES: 


CHKSTS 

ERRSTS 

MBXEBK 

ERRPRO 


CHKSTS. INC  --  CHECK  STATUS 

ERRSTS. INC  --  IISS  ERROR  CODES 

MBXEBK. INC  --  MAILBOX  EVENT  BLOCK  DESCRIPTION 

PROCESS  ERROR  INCLUDE  pILE 


ROUTINES  CALLED: 


SDELMB  -  DELETE  THE  MAILBOX 

SDEACH  -  DEASSIGN  CHANNEL  FROM  THE  MAILBOX 

ERRPRO  -  PROCESS  ERROR 
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I PC  Module  Documentation 

NAME :  ENDRUN 


PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP 

DESCRIPTION: 


-  THE  IBM  NEEDS  A 
STOP  THE  PROGRAM, 


STOP  THE  PROGRAM 

VAX- 11  COBOL 

PROGRAM 

ENDRUN 

.COB 

VAX 

I  PC 

I  PC 


SPECIAL  ROUTINE  TO 
THEREFORE  WE  ALL  DO. 
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I PC  Module  Documentation 


* 


NAME  : 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 


ERRFTL 

PROCESS  FATAL  ERROR 

VAX- 11  COBOL 

SUBROUTINE 

ERRFTL 

.COB 

ERR 

I  PC 


DESCRIPTION: 


-  This  module  date  and  time  stamps  the 
error  message,  assigns  a  function  code 
and  writes  the  error  message  to  a 
file  called  ERRFTL 


ARGUMENTS :  I 

I 


RET-STATUS  =  DSPLY  [X(5)3 
MODULE-NAME  =  DSPLY  [X(6)] 
MESG-DESC  =  DSPLY  [X(60)3 
ORIGINAL-ERR-MSG  =*  DSPLY  [X(109)] 


INCLUDE  FILES: 

CHKSTS  -  CHKSTS . INC  --  CHECK  STATUS 

ROUTINES  CALLED: 

GETPNM  -  GET  PROCESS  NAME 

CALLED  DIRECTLY  BY: 

ERRPRO  -  PROCESS  ERROR 


*  * 
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USED  IN  MAIN 


CNLTIM 

CRTMBX 

DELMBX 

GETMSG 

LOCKEF 

RCVMSG 

RELEVB 

SETTIM 

SNDMSG 

WAIT01 

WAIT02 

WAIT03 


PROGRAM(S) : 


-  CANCEL  A  TIMER 

-  CREATE  A  MAILBOX 

-  DELETE  A  MAILBOX 

-  GET  A  MESSAGE  FROM  ANOTHER  PROGRAM 

-  LOCK  EVENT  FLAG 

-  RECEIVE  A  MESSAGE  FROM  ANOTHER  PROGRAM 

-  RELEASE  A  TARGET  EVENT  BLOCK  (CLEAR  IT)  AND 

-  START  A  TIMER 

-  SEND  A  MESSAGE  TO  ANOTHER  PROGRAM 

-  WAIT  FOR  AN  EVENT  TO  OCCUR 

-  WAIT  FOR  AN  EVENT  TO  OCCUR 

-  WAIT  FOR  AN  EVENT  TO  OCCUR 
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I PC  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 


ERRPRO 

PROCESS  ERROR 

VAX- 11  COBOL 

SUBROUTINE 

ERRPRO 

-COB 

ERR 

I  PC 


DESCRIPTION: 


LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


ARGUMENTS : 


RET-STATUS  =  DSPLY  [X(5)] 
MODULE-NAME  «  DSPLY  [X(6)] 
MESG-DESC  =  DSPLY  [X(60)] 


INCLUDE  FILES: 


CHKSTS  -  CHKSTS . INC  --  CHECK  STATUS 


ROUTINES  CALLED: 


GETPNM  -  GET  PROCESS  NAME 

WRTERR  -  WRITE  MESSAGE  TO  MAILBOX 

ERRFTL  -  PROCESS  FATAL  ERROR 


CALLED  DIRECTLY  BY: 


CNLTIM  -  CANCEL  A  TIMER 

CRTMBX  -  CREATE  A  MAILBOX 

DELMBX  -  DELETE  A  MAILBOX 
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GETMSG 

RCVMSG 

RELEVB 

SETTIM 

SNDMSG 

WAIT01 

WAIT02 

WAIT03 

CNLTMR 

FREVTF 

LOCKEF 

RDMALF 

SASGCH 

SCRTMB 

SDEACH 

SDELMB 

SETTMR 

SWEVTF 

VALMBE 

WRTMAI 


GET  A  MESSAGE  FROM  ANOTHER  PROGRAM 
RECEIVE  A  MESSAGE  FROM  ANOTHER  PROGRAM 
RELEASE  A  TARGET  EVENT  BLOCK  (CLEAR  IT)  AND 
START  A  TIMER 

SEND  A  MESSAGE  TO  ANOTHER  PROGRAM 
WAIT  FOR  AN  EVENT  TO  OCCUR 
WAIT  FOR  AN  EVENT  TO  OCCUR 
WAIT  FOR  AN  EVENT  TO  OCCUR 
CANCEL  THE  TIMER 
FREE  THE  EVENT  FLAG 
LOCK  EVENT  FLAG 

READ  THE  MAILBOX  FOR  EVENT  FLAG  SET 
ASSIGN  A  CHANNEL  TO  A  MAILBOX 
CREATE  A  MAILBOX 

DEASSIGN  CHANNEL  FROM  THE  MAILBOX 
DELETE  THE  MAILBOX 
SET  A  TIMER 

WAIT  FOR  ONE  OF  POSSIBLY  MANY  EVENTS 
VALIDATE  THAT  MAILBOX  ALREADY  EXISTS 
WRITE  THE  MESSAGE  INTO  THE  MAILBOX 


USED  IN  MAIN  PROGRAM(S) : 


CNLTIM 

CRTMBX 

DELMBX 

GETMSG 

LOCKEF 

RCVMSG 

RELEVB 

SETTIM 

SNDMSG 

WAIT01 

WAIT02 

WAIT03 


CANCEL  A  TIMER 
CREATE  A  MAILBOX 
DELETE  A  MAILBOX 

GET  A  MESSAGE  FROM  ANOTHER  PROGRAM 
LOCK  EVENT  FLAG 

RECEIVE  A  MESSAGE  FROM  ANOTHER  PROGRAM 
RELEASE  A  TARGET  EVENT  BLOCK  (CLEAR  IT)  AND 
START  A  TIMER 

SEND  A  MESSAGE  TO  ANOTHER  PROGRAM 
WAIT  FOR  AN  EVENT  TO  OCCUR 
WAIT  FOR  AN  EVENT  TO  OCCUR 
WAIT  FOR  AN  EVENT  TO  OCCUR 


3-47 


PS  620143200 
1  November  1985 


I PC  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 

DESCRIPTION: 


FREVTF 

FREE  THE  EVENT  FLAG 

VAX- 11  FORTRAN 

SUBROUTINE 

FREVTF 

.FOR 

VAX 

I  PC 

I  PC 


:-  THIS  MODULE  RELEASES  AN  EVENT  FLAG  THAT 
WAS  PREVIOUSLY  OBTAINED  FROM  THE  SYSTEM. 


ARGUMENTS : 


EVTFLG  -  1*2 

RSTATS  -  CHAR 


ROUTINES  CALLED: 


ERR PRO  -  PROCESS  ERROR 

LIBSFREE  EF 


CALLED  DIRECTLY  BY: 


CNLTIM  -  CANCEL  A  TIMER 

GETMSG  -  GET  A  MESSAGE  FROM  ANOTHER  PROGRAM 


USED  IN  MAIN  PROGRAM ( S ) : 


CNLTIM  -  CANCEL  A  TIMER 

GETMSG  -  GET  A  MESSAGE  FROM  ANOTHER  PROGRAM 
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I PC  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 


GETMSG 

GET  A  MESSAGE  FROM  ANOTHER  PROGRAM 

VAX- 11  COBOL 

SUBROUTINE 

GETMSG 

.COB 

VAX 

I  PC 

I  PC 


DESCRIPTION: 


-  IT  ACCEPTS  THE  MESSAGE  THAT  WAS  SENT  FROM 
ANOTHER  PORGRAM  RUNNING  ON  THE  SAME  COMPUTER 
AND  MOVES  IT  INTO  THE  GIVEN  BUFFER. 


ARGUMENTS : 


INPUT-MAILBOX-NAME  =  DSPLY  tX(14)] 
BUFFER  =  DSPLY  [X(2000)] 
BUFFER-SIZE  =  DSPLY  19(4)] 

NUMBER -OF -BYTES  *  DSPLY  [9(4)] 
MAILBOX -EVENT- BLOCK  =  RECRD 
RET-STATUS  =  DSPLY  [X(5)] 


INCLUDE  FILES: 


CHKSTS 

KIPC 

ERRSTS 

MBXEBK 

ERRPRO 


CHKSTS. INC  --  CHECK  STATUS 

KIPC. INC  --  CONSTAND  BLOCK  FOR  IPC  PRIMITIVES 
ERRSTS. INC  --  IISS  ERROR  CODES 
MBXEBK. INC  --  MAILBOX  EVENT  BLOCK  DESCRIPTION 
PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


FREVTF  -  FREE  THE  EVENT  FLAG 

ERRPRO  -  PROCESS  ERROR 
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I PC  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 

DESCRIPTION: 


GETPNM 

GET  PROCESS  NAME 
VAX- 11  FORTRAN 
SUBROUTINE 
GETPNM 
.FOR 

ERR 

I  PC 


GET  THE  NAME  OF  THE  CALLING  PROCESS 


ARGUMENTS : 


PRCNAM  =  CHAR 

-  Process  name 
RSTATS  «  CHAR 

-  Return  status 


INCLUDE  FILES: 


ERRSTS . INF  - 
( $ JPIDEF )  - 


****  PURPOSE 
****  PURPOSE 


NOT  FOUND  BY 
NOT  FOUND  BY 


STRIPPER  **** 
STRIPPER  **** 


ROUTINES  CALLED: 


SYSSGETJPI 


CALLED  DIRECTLY  BY: 


ERRFTL 

ERRPRO 


-  PROCESS  FATAL  ERROR 

-  PROCESS  ERROR 


USED  IN  MAIN  PROGRAM C  S ) 
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CNLTIM 

CRTMBX 

DELMBX 

GETMSG 

LOCKEF 

RCVMSG 

RELEVB 

SETTIM 

SNDMSG 

WAIT01 

WAIT02 

WAIT03 


-  CANCEL  A  TIMER 

-  CREATE  A  MAILBOX 

-  DELETE  A  MAILBOX 

-  GET  A  MESSAGE  FROM  ANOTHER  PROGRAM 

-  LOCK  EVENT  FLAG 

-  RECEIVE  A  MESSAGE  FROM  ANOTHER  PROGRAM 

-  RELEASE  A  TARGET  EVENT  BLOCK  (CLEAR  IT)  AND 

-  START  A  TIMER 

-  SEND  A  MESSAGE  TO  ANOTHER  PROGRAM 

-  WAIT  FOR  AN  EVENT  TO  OCCUR 

-  WAIT  FOR  AN  EVENT  TO  OCCUR 

-  WAIT  FOR  AN  EVENT  TO  OCCUR 
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I PC  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 


LOCKEF 

LOCK  EVENT  FLAG 

VAX- 11  FORTRAN 

SUBROUTINE 

LOCKEF 

.FOR 

VAX 

I  PC 

I  PC 


DESCRIPTION: 


LOCK  EVENT  FLAG  FROM  BEING  USED  UNTIL  FREED. 


INCLUDE  FILES: 


ERRSTS . INF  -  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  ***♦ 


ROUTINES  CALLED: 


ERRPRO  -  PROCESS  ERROR 

LIBSGET  EF 
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IPC  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP 


RCVMSG 

RECEIVE  A  MESSAGE  FROM  ANOTHER  PROGRAM 

VAX- 11  COBOL 

SUBROUTINE 

RCVMSG 

.COB 

VAX 

IPC 


DESCRIPTION: 


ARGUMENTS 


INPUT-MAILBOX-NAME  *  DSPLY  tX(14)] 
EVENT -NUMBER  -  DSPLY  [99] 
MAILBOX-EVENT-BLOCK  =  RECRD 
RET-STATUS  =  DSPLY  [X(5)] 


INCLUDE  FILES: 


CHKSTS 

ERRSTS 

KIPC 

MBXEBK 

ERRPRO 


-  CHKSTS. INC  —  CHECK  STATUS 

-  ERRSTS. INC  --  IISS  ERROR  CODES 

-  KIPC. INC  --  CONSTAND  BLOCK  FOR  IPC  PRIMITIVES 

-  MBXEBK. INC  --  MAILBOX  EVENT  BLOCK  DESCRIPTION 

-  PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


RDMALF 

ERRPRO 


-  READ  THE  MAILBOX  FOR  EVENT  FLAG  SET 

-  PROCESS  ERROR 
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I PC  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 

DESCRIPTION: 


RDMALF 

READ  THE  MAILBOX 

VAX- 11  FORTRAN 

SUBROUTINE 

RDMALF 

.FOR 

VAX 

I  PC 

I  PC 


FOR  EVENT  FLAG  SET 


:-  ISSUE  QIO  WITH  EVENT  FLAG  TO  READ  MESSAGE 
FROM  MAILBOX  USING  THE  CHANNEL  NUMBER 


ARGUMENTS : 


CHANNL  =  1*2 

-CHANNEL  NUMBER 
EVTFLG  =  1*2 

-EVENT  FLAG 
EVTBLK  =  L* 1  (1) 

-MAILBOX  EVENT  BLOCK 
BUFLEN  =  1*2 

-MAXIMUM  BUFFER  LENGTH 
RSTATS  =  CHAR 

-RETURN  STATUS 


INCLUDE  FILES: 


ERRSTS . INF  -  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  ***» 


ROUTINES  CALLED: 


ERRPRO  -  PROCESS  ERROR 

LIBSGET  EF 

SYSJQIO 
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CALLED  DIRECTLY  BY: 

RCVMSG  -  RECEIVE  A  MESSAGE  FROM  ANOTHER  PROGRAM 

USED  IN  MAIN  PROGRAM ( S ) : 

RCVMSG  -  RECEIVE  A  MESSAGE  FROM  ANOTHER  PROGRAM 
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I PC  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 


RELEVB 

RELEASE  A  TARGET  EVENT  BLOCK  (CLEAR  IT) 
AND 

VAX- 11  COBOL 

SUBROUTINE 

RELEVB 

.COB 

VAX 

I  PC 

I  PC 


DESCRIPTION: 


-  DEASSIGN  THE  CHANNEL  ASSIGNED  TO  THE 
TARGET  MAILBOX. 


ARGUMENTS : 


TARGET-MAILBOX-NAME  =  DSPLY  [X(14)] 
MAILBOX -EVENT-BLOCK  =  RECRD 
RET-STATUS  =  DSPLY  [X(5)] 


INCLUDE  FILES: 


ERRSTS 

CHKSTS 

MBXEBK 

ERRPRO 


ERRSTS. INC  --  IISS  ERROR  CODES 
CHKSTS. INC  --  CHECK  STATUS 

MBXEBK. INC  --  MAILBOX  EVENT  BLOCK  DESCRIPTION 
PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


SDEACH 

ERRPRO 


DEASSIGN  CHANNEL  FROM  THE  MAILBOX 
PROCESS  ERROR 
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I PC  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 

DESCRIPTION: 


: -ASSIGN  A  CHANNEL  NUMBER  TO  MAILBOX 


SASGCH 

ASSIGN  A  CHANNEL  TO  A  MAILBOX 

VAX- 11  FORTRAN 

SUBROUTINE 

SASGCH 

.FOR 

VAX 

I  PC 

I  PC 


ARGUMENTS : 


MBXNAM  «  CHAR 

-MAILBOX  NAME 
CHANNL  *  1*2 

-CHANNEL  NUMBER 
RSTATS  -  CHAR 

-RETURN  STATUS 


INCLUDE  FILES: 


ERRSTS . INF  -  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  *•** 


ROUTINES  CALLED: 

ERRPRO  -  PROCESS  ERROR 

SYSSASSIGN 

CALLED  DIRECTLY  BY: 

SNDMSG  -  SEND  A  MESSAGE  TO  ANOTHER  PROGRAM 
USED  IN  MAIN  PROGRAM ( S ) : 
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I PC  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 
SOURCE  FILE: 
SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 


DOCUMENTATION  GROUP:  I PC 


DESCRIPTION: 


:-  TO  CREATE  A  MAILBOX  USING  THE  NAME  AND  THE 
SIZE  SPECIFIED.  IT  ALSO  DISABLES  THE  RESOURCE 
WAIT  MODE  TO  ALLOW  CONTROL  RETURN  TO  CALLING  PROGRAM 
IMMEDIATELY  WITHOUT  WAITING  FOR  THE  RESOURCE 
TO  BE  AVAILABLE,  SUCH  AS  THE  MAILBOX  FULL. 


ARGUMENTS : 


SCRTMB 

CREATE  A  MAILBOX 

VAX- 11  FORTRAN 

SUBROUTINE 

SCRTMB 

.FOR 

VAX 

I  PC 


MBXNAM  =  CHAR 

-MAILBOX  NAME 
MBXSIZ  =  1*2 

-MAILBOX  SIZE 
CHANNL  =  1*2 

-CHANNEL  NUMBER 
RSTATS  =  CHAR 

-RETURN  STATUS 


INCLUDE  FILES: 

ERRSTS . INF  -  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 


ERRPRO  -  PROCESS  ERROR 

SYSSCREMBX 

SYSSSETRWM 
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CALLED  DIRECTLY  BY: 

CRTMBX  -  CREATE  A 

USED  IN  MAIN  PROGRAM ( S ) 


MAILBOX 


CRTMBX 


-  CREATE  A  MAILBOX 
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IPC  Module  Documentation 


NAME :  SDEACH 

PURPOSE:  DEASSIGN  CHANNEL  FROM  THE  MAILBOX 

LANGUAGE:  VAX- 11  FORTRAN 

MODULE  TYPE :  SUBROUTINE 

SOURCE  FILE :  SDEACH 

SOURCE  FILE  TYPE:  .FOR 

HOST :  VAX 

SUBSYSTEM:  IPC 

SUBDIRECTORY : 

DOCUMENTATION  GROUP:  IPC 

DESCRIPTION: 


: -DEASSIGN  A  MAILBOX  CHANNEL  NUMBER 


ARGUMENTS : 


CHANNL  -  1*2 

-CHANNEL  NUMBER 
RSTATS  *  CHAR 

-RETURN  STATUS 


INCLUDE  FILES: 


ERRSTS . INF  -  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 


ROUTINES  CALLED: 


ERRPRO  -  PROCESS  ERROR 
SYSSDASSGN 


CALLED  DIRECTLY  BY: 


DELMBX  -  DELETE  A  MAILBOX 

RELEVB  -  RELEASE  A  TARGET  EVENT  BLOCK  (CLEAR  IT)  AND 


USED  IN  MAIN  PROGRAM ( S ) : 


mwmw '  wm 
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DELMBX  -  DELETE  A  MAILBOX 

RELEVB  -  RELEASE  A  TARGET  EVENT  BLOCK  (CLEAR  IT)  AND 
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I PC  Module  Documentation 


NAME :  SDELMB 

PURPOSE:  DELETE  THE  MAILBOX 

LANGUAGE:  VAX- 11  FORTRAN 

MODULE  TYPE:  SUBROUTINE 

SOURCE  FILE :  SDELMB 

SOURCE  FILE  TYPE:  .FOR 

HOST :  VAX 

SUBSYSTEM:  I PC 

SUBDIRECTORY: 

DOCUMENTATION  GROUP:  I PC 

DESCRIPTION: 

:-  TO  DELETE  A  MAILBOX  USING  THE  CHANNEL  NUMBER 


ARGUMENTS : 


CHANNL 


RSTATS 


■  1*2 

-CHANNEL  NUMBER 
CHAR 

-RETURN  STATUS 


INCLUDE  FILES: 

ERRSTS . INF  -  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 


ROUTINES  CALLED: 


ERRPRO  -  PROCESS  ERROR 
SYS $ DELMBX 


CALLED  DIRECTLY  BY: 


DELMBX 


-  DELETE  A  MAILBOX 


USED  IN  MAIN  PROGRAM(S): 


DELMBX 


-  DELETE  A  MAILBOX 


A 

:•> 

■ » 
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I PC  Module  Documentation 


NAME:  SETT1M 

PURPOSE:  START  A  TIMER 

LANGUAGE:  VAX- 11  COBOL 

MODULE  TYPE :  SUBROUTINE 

SOURCE  FILE:  SETTIM 

SOURCE  FILE  TYPE:  .COB 

HOST :  VAX 

SUBSYSTEM:  I PC 

SUBDIRECTORY: 

DOCUMENTATION  GROUP:  I PC 

DESCRIPTION: 


REQUEST  A  TIMER  TO  START  RUNNING.  THE 
PROGRAM  CONTINUES  TO  EXECUTE  WITH  THE 
ELAPSED  TIME  BEING  DISCOVERED  IN  THE 
WAITEB  PRIMITIVE. 


ARGUMENTS : 


TIME-INTERVAL  -  RECRD 
EVENT-NUMBER  -  DSPLY  [99] 
TIMER-EVENT-BLOCK  -  RECRD 
RET-STATUS  -  DSPLY  [X(5)l 


INCLUDE  FILES: 


CHKSTS  -  CHKSTS . INC  --  CHECK  STATUS 

ERRSTS  -  ERRSTS . INC  --  IISS  ERROR  CODES 

TIMREB  -  TIMREB . INC  --  TIME  EVENT  BLOCK  DESCRIPTION 

ERRPRO  -  PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


SETTMR  -  SET  A  TIMER 

ERRPRO  -  PROCESS  ERROR 
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I PC  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP 


SETTMR 

SET  A  TIMER 

VAX- 11  FORTRAN 

SUBROUTINE 

SETTMR 

.FOR 

VAX 

I  PC 

:  IPC 


DESCRIPTION: 


SET  A  TIMER  WITH  AN  EVENT  FLAG 
REQUEST  IDENTIFICATION  IS  4 


ARGUMENTS : 


INTVAL  *  CHAR 

-  TIME  INTERVAL  -  HHMMSS 

EVTFLG  =  1*2 

-  EVENT  FLAG  NUMBER 
RSTATS  =  CHAR 

-  RETURN  STATUS 


INCLUDE  FILES: 


ERRSTS . INF  -  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  »*** 


ROUTINES  CALLED: 


ERRPRO  -  PROCESS  ERROR 

LIBSGETEF 

SYSSBINTIM 

SYSSSETIMR 


CALLED  DIRECTLY  BY : 


SETTIM  -  START  A  TIMER 
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USED  IN  MAIN  PROGRAM C  S ) : 
SETTIM  -  START  A  TIMER 
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I PC  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST : 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 


SNDMSG 

SEND  A  MESSAGE  TO  ANOTHER  PROGRAM 

VAX- 11  COBOL 

SUBROUTINE 

SNDMSG 

.COB 

VAX 

I  PC 

I  PC 


DESCRIPTION: 


-  IT  SENDS  A  MESSAGE  TO  ANOTHER  PROGRAM 
RUNNING  ON  THE  SAME  COMPUTER  THROUGH  THE 
INPUT  MAILBOX  OF  THE  OTHER  PROGRAM. 


ARGUMENTS : 


TARGET-MAILBOX-NAME  -  DSPLY  [X(14>] 
BUFFER  *  DSPLY  [X(2000)] 
NUMBER-OF-BYTES  -  DSPLY  [9(4)3 
MAILBOX-EVENT-BLOCK  -  RECRD 
RET-STATUS  -  DSPLY  [X(5)3 


INCLUDE  FILES: 


CHKSTS 

ERRSTS 

KIPC 

MBXEBK 

ERRPRO 


CHKSTS. INC  --  CHECK  STATUS 

ERRSTS. INC  --  IISS  ERROR  CODES 

KIPC. INC  --  CONSTAND  BLOCK  FOR  IPC  PRIMITIVES 

MBXEBK. INC  --  MAILBOX  EVENT  BLOCK  DESCRIPTION 

PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


WRTMAI  -  WRITE  THE  MESSAGE  INTO  THE  MAILBOX 

SASGCH  -  ASSIGN  A  CHANNEL  TO  A  MAILBOX 

ERRPRO  -  PROCESS  ERROR 
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I  PC  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 


SWEVTF 

WAIT  FOR  ONE  OF  POSSIBLY  MANY  EVENTS 

VAX- 11  FORTRAN 

SUBROUTINE 

SWEVTF 

.FOR 

VAX 

I  PC 


IPv 


DESCRIPTION: 


:-  THIS  MODULE  SET  UP  THE  EVENT  CLUSTER  AND  WAITS 
FOR  ONE  OF  THE  EVENT  TO  HAPPEN. 


ARGUMENTS : 

ENARRY  = 

1*2 

(22) 

EVTFLG  = 

1*2 

(22) 

EVTNUM  = 

1*2 

RSTATS  = 

CHAR 

ROUTINES  CALLED: 


ERRPRO  -  PROCESS  ERROR 

LIBSFREEEF 

SYSSCLREF 

SYSSWFLOR 


CALLED  DIRECTLY  BY: 


WAIT01 

WAIT02 

WAIT03 


WAIT  FOR  AN  EVENT  TO  OCCUR 
WAIT  FOR  AN  EVENT  TO  OCCUR 
WAIT  FOR  AN  EVENT  TO  OCCUR 


USED  IN  MAIN  PROGRAM ( S ) : 


WAIT01 


WAIT  FOR  AN  EVENT  TO  OCCUR 
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WAIT02 

WAIT03 


WAIT  FOR  AN  EVENT  TO  OCCUR 
WAIT  FOR  AN  EVENT  TO  OCCUR 
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IPC  Module  Documentation 


NAME  : 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP 

DESCRIPTION: 


:-  THIS  MODULE  CHECKS  TO  SEE  IF  MAILBOX 
ALREADY  EXISTS. 


ARGUMENTS : 


INMBNM  =  CHAR 

-INPUT  MAILBOX  NAME 
RSTATS  =  CHAR 

-RET  STATUS 


INCLUDE  FILES: 


ERRSTS . INF  -  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 


ROUTINES  CALLED: 


ERRPRO  -  PROCESS  ERROR 

SYSSGETDEV 


VALMBE 

VALIDATE  THAT  MAILBOX  ALREADY  EXISTS 

VAX- 11  FORTRAN 

SUBROUTINE 

VALMBE 

.FOR 

VAX 

IPC 

:  IPC 
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CRTMBX  -  CREATE  A  MAILBOX 


3-71 


PS  620143200 
1  November  1985 


I PC  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE- 
SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 


WAIT01 

WAIT  FOR  AN  EVENT  TO  OCCUR 

VAX- 11  COBOL 

SUBROUTINE 

WAIT01 

.COB 

VAX 

I  PC 

I  PC 


DESCRIPTION: 


-  IT  WAITS  FOR  ONE  OF  OUTSTANDING  REQUESTS  THAT 
ARE  ASSOCIATED  WITH  THE  LIST  OF  EVENT  BLOCKS 
TO  BE  SATISFIED.  THE  EVENT  NUMBER  ASSOCIATED 
WITH  THE  COMPLETED  REQUEST  IS  RETURNED  IN  THE 
EVENT  NUMBER  VARIABLE. 


ARGUMENTS : 


EVENT-NUMBER  *  DSPLY  [99] 

RET-STATUS  -  DSPLY  [X(5)3 
NUMBER-OF-EVENT-BLOCKS  =  DSPLY  [99] 
MBX-EVENT-BLOCK-Ol  -  RECRD 


INCLUDE  FILES: 


CHKSTS  -  CHKSTS . INC  --  CHECK  STATUS 

ERRSTS  -  ERRSTS . INC  --  IISS  ERROR  CODES 

MBEB01  -  MBEB01 . INC  --  MAILBOX  EVENT  BLOCK  DESCRIPTION 

ERRPRO  -  PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


SWEVTF  -  WAIT  FOR  ONE  OF  POSSIBLY  MANY  EVENTS 

ERRPRO  -  PROCESS  ERROR 
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I PC  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 


WAIT02 

WAIT  FOR  AN  EVENT  TO  OCCUR 

VAX- 11  COBOL 

SUBROUTINE 

WAIT02 

.COB 

VAX 

I  PC 

I  PC 


DESCRIPTION: 


-  IT  WAITS  FOR  ONE  OF  OUTSTANDING  REQUESTS  THAT 
ARE  ASSOCIATED  WITH  THE  LIST  OF  EVENT  BLOCKS 
TO  BE  SATISFIED.  THE  EVENT  NUMBER  ASSOCIATED 
WITH  THE  COMPLETED  REQUEST  IS  RETURNED  IN  THE 
EVENT  NUMBER  VARIABLE. 


ARGUMENTS : 


EVENT-NUMBER  =  DSPLY  [99] 

RET- STATUS  «=  DSPLY  [X(5)J 
NUMBER-OF-EVENT-BLOCKS  *  DSPLY  [99] 
MBX-EVENT-BLOCK-Ol  =  RECRD 
MBX- EVENT- BLOCK -02  =  RECRD 


INCLUDE  FILES: 


CHKSTS 

ERRSTS 

MBEBOl 

MBEB02 

ERRPRO 


CHKSTS. INC  -- 
ERRSTS. INC  -- 
MBEBOl. INC  -- 
MBEB02 . INC  -- 
PROCESS  ERROR 


CHECK  STATUS 

IISS  ERROR  CODES 

MAILBOX  EVENT  BLOCK  DESCRIPTION 

MAILBOX  EVENT  BLOCK  DESCRIPTION 

INCLUDE  FILE 


ROUTINES  CALLED: 


SWEVTF 


WAIT  FOR  ONE  OF  POSSIBLY  MANY  EVENTS 


PS  620143200 
1  November  1985 


* 

► 

|  errpro 


-  PROCESS  ERROR 


PS  620143200 
1  November  1985 


I PC  Module  Documentation 


NAME : 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE : 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 


WAIT03 

WAIT  FOR  AN  EVENT  TO  OCCUR 

VAX- 11  COBOL 

SUBROUTINE 

WAIT03 

.COB 

VAX 

I  PC 

I  PC 


DESCRIPTION: 


-  IT  WAITS  FOR  ONE  OF  OUTSTANDING  REQUESTS  THAT 
ARE  ASSOCIATED  WITH  THE  LIST  OF  EVENT  BLOCKS 
TO  BE  SATISFIED.  THE  EVENT  NUMBER  ASSOCIATED 
WITH  THE  COMPLETED  REQUEST  IS  RETURNED  IN  THE 
EVENT  NUMBER  VARIABLE. 


ARGUMENTS : 


EVENT-NUMBER  -  DSPLY  [99] 

RET-STATUS  *  DSPLY  [X(5)3 
NUMBER-OF-EVENT-BLOCKS  =  DSPLY  [99] 
MBX-EVENT-BL0CK-01  -  RECRD 
MBX-EVENT-BLOCK-02  -  RECRD 
MBX-EVENT-BLOCK-03  -  RECRD 


INCLUDE  FILES: 


CHKSTS 
ERRSTS 
MBEB01 
MBEB02 
MBEB03 
ERR PRO 


CHKSTS. INC  --  CHECK  STATUS 

ERRSTS. INC  --  IISS  ERROR  CODES 

MBEB01 . INC  --  MAILBOX  EVENT  BLOCK  DESCRIPTION 

MBEB02 . INC  --  MAILBOX  EVENT  BLOCK  DESCRIPTION 

MBEB03 . INC  --  MAILBOX  EVENT  BLOCK  DESCRIPTION 

PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 
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SWEVTF  -  WAIT  FOR  ONE  OF  POSSIBLY  MANY  EVENTS 

ERRPRO  -  PROCESS  ERROR 
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IPC  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 
SOURCE  FILE: 
SOURCE  FILE  TYPE: 


WRTERR 

WRITE  MESSAGE  TO  MAILBOX 
VAX- 11  FORTRAN 
SUBROUTINE 
WRTERR 
.FOR 


HOST: 

SUBSYSTEM :  ERR 

SUBDIRECTORY : 
DOCUMENTATION  GROUP:  IPC 


DESCRIPTION: 


ISSUE  QIO  TO  WRITE  A  MESSAGE  TO  MAILBOX 


ARGUMENTS : 


MBXNAM  -  CHAR 

-MAILBOX  NAME 
BUFLEN  =  1*2 

-MAXIMUM  BUFFER  LENGTH 
INBUF  =  L* 1  (1) 

-MESSAGE 
RSTATS  =  CHAR 

-RETURN  STATUS 


INCLUDE  FILES: 


ERRSTS . INF  -  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 


ROUTINES  CALLED: 


LIBSFREEEF 

LIB$GET_EF 

SYS J ASSIGN 

SYSJBINTIM 

SYSSDASSGN 

SYSJQIOW 

SYSSSETIMR 

SYSSWAITFR 
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CALLED  DIRECTLY  BY: 


ERRPRO  -  PROCESS  ERROR 


USED  IN  MAIN  PROGRAM ( S ) : 


CNLTIM  -  CANCEL  A  TIMER 

CRTMBX  -  CREATE  A  MAILBOX 

DELMBX  -  DELETE  A  MAILBOX 

GETMSG  -  GET  A  MESSAGE  FROM  ANOTHER  PROGRAM 
LOCKEF  -  LOCK  EVENT  FLAG 

RCVMSG  -  RECEIVE  A  MESSAGE  FROM  ANOTHER  PROGRAM 

RELEVB  -  RELEASE  A  TARGET  EVENT  BLOCK  (CLEAR  IT)  AND 

SETTIM  -  START  A  TIMER 

SNDMSG  -  SEND  A  MESSAGE  TO  ANOTHER  PROGRAM 

WAIT01  -  WAIT  FOR  AN  EVENT  TO  OCCUR 

WAIT02  -  WAIT  FOR  AN  EVENT  TO  OCCUR 

WAIT03  -  WAIT  FOR  AN  EVENT  TO  OCCUR 


3-78 


PS  620143200 
1  November  1985 


I PC  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 


WRTMAI 

WRITE  THE  MESSAGE  INTO  THE  MAILBOX 

VAX- 11  FORTRAN 

SUBROUTINE 

WRTMAI 

.FOR 

VAX 

I  PC 

I  PC 


DESCRIPTION: 


ISSUE  QIO  TO  WRITE  A  MESSAGE  TO  MAILBOX 
ARGUMENTS : 


CHANNL  «  1*2 

-CHANNEL  NUMBER 
BUFLEN  =  1*2 

-MAXIMUM  BUFFER  LENGTH 
INBUF  -  L* 1  (1) 

-MESSAGE 
RSTATS  ■=  CHAR 

-RETURN  STATUS 


INCLUDE  FILES: 


ERRSTS . INF  -  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 


ROUTINES  CALLED: 


ERRPRO  -  PROCESS  ERROR 

SYSSQIOW 


CALLED  DIRECTLY  BY: 


SNDMSG  -  SEND  A  MESSAGE  TO  ANOTHER  PROGRAM 
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USED  IN  MAIN  PROGRAM ( S ) : 

SNDMSG  -  SEND  A  MESSAGE  TO  ANOTHER  PROGRAM 
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3.10.9  Include  File  Descriptions 

The  following  list  contains  a  purpose  and  description  of 
each  include  file  listed  in  3.10.4  as  specified  in  the  source 
code.  The  language  it  is  written  in  is  also  given. 
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IPC  Include  File  Description 


FILE  NAME:  CHKSTS 

PURPOSE:  CHKSTS. INC  —  CHECK  STATUS 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 
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IPC  Include  File  Description 


FILE  NAME:  ERRPRO 

PURPOSE:  PROCESS  ERROR  INCLUDE  FILE 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 
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IPC  Include  File  Description 


FILE  NAME:  ERRSTS 

PURPOSE:  ERRSTS. INC  --  IISS  ERROR  CODES 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


THIS  FILE  CONTAINS  ALL  IISS  ERROR  CODES  DEFINED  IN 
COBOL  FORMAT 
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IPC  Include  File  Description 


FILE  NAME:  KIPC 

PURPOSE:  KIPC. INC  —  CONSTAND  BLOCK  FOR  IPC  PRIMITIVES 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


* 

* 


THIS  FILE  CONTAINS  ALL  CONSTANT  DATA  ITEMS 
USED  IN  THE  IPC  PRIMITIVES. 
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IPC  Include  File  Description 


FILE  HAME •  MBEB01 

PURPOSE:  MBEB01 . INC  —  MAILBOX  EVENT  BLOCK  DESCRIPTION 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 
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IPC  Include  File  Description 


FILE  NAME:  MBEB02 

PURPOSE:  MBEB02 . INC  --  MAILBOX  EVENT  BLOCK  DESCRIPTION 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 
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IPC  Include  File  Description 


FILE  NAME:  MBEB03 

PURPOSE:  MBEB03 . INC  --  MAILBOX  EVENT  BLOCK  DESCRIPTION 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 
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I PC  Include  Pile  Description 


FILE  NAME:  MBXEBK 

PURPOSE:  MBXEBK. INC  —  MAILBOX  EVENT  BLOCK  DESCRIPTION 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 
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I PC  Include  File  Description 


FILE  NAME:  TIMREB 

PURPOSE:  TIMREB. INC  --  TIME  EVENT  BLOCK  DESCRIPTION 

LANGUAGE:  VAX- 11  COBOL 


DESCRIPTION: 
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3.10.10  Hierarchy  Chart 

The  following  hierarchy  charts  show  the  relationships 
between  all  of  the  modules  mentioned  in  the  above  documentation. 
A  module  may  call  a  subroutine  several  times  within  its  code, 
but  the  call  will  only  be  shown  once  as  a  single  relationship  on 
this  hierarchy  chart.  All  modules  shown  at  the  top  of  the  first 
page  are  considered  Main  Programs  as  described  in  section  3.10.1 
above . 

There  is  an  internal  paging  scheme  as  marked  by  the  numbers 
in  the  upper  right  corner  of  each  page.  An  index  after  the  last 
page  of  the  chart  shows  where  a  routine  and  its  calls  are  first 
defined.  If  a  routine  has  no  page  reference,  it  either  makes  no 
calls  or  is  an  external  routine.  A  continuation  box  on  the  end 
of  a  tree  limb  shows  where  that  the  tree  continues  on  the  page 
numbered  mentioned.  A  number  in  a  box  with  a  routine  name 
points  to  the  page  where  the  routine  is  further  defined  within 
the  hierarchy  tree.  If  there  is  no  number  in  a  box,  the  routine 
either  makes  no  calls  or  is  am  external  routine. 
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3.11  Program  Listings  Comments 


C 

•7*1 


This  information  is  contained  in  the  Module  Descriptions  in 
section  3.10. 
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SECTION  4 

QUALITY  ASSURANCE  PROVISIONS 


4.1  Introduction  and  Definitions 


“Testing"  is  a  systematic  process  that  may  be  preplanned 
and  explicitly  stated.  Test  techniques  and  procedures  may  be 
defined  in  advance,  and  a  sequence  of  test  steps  may  be 
specified.  “Debugging"  is  the  process  of  isolation  and 
correction  of  the  cause  of  an  error. 

"Antibugging"  is  defined  as  the  philosophy  of  writing 
programs  in  such  a  way  as  to  make  bugs  less  likely  to  occur  and 
when  they  do  occur,  to  make  them  more  noticeable  to  the 
programmer  and  the  user.  In  other  words,  as  much  error  checking 
as  is  practical  and  possible  in  each  routine  should  be 
performed . 

4 . 2  Computer  Programming  Test  and  Evaluation 

The  quality  assurance  provisions  for  test  consists  of  the 
normal  testing  techniques  that  are  accomplished  during  the 
construction  process.  They  consist  of  design  and  code 
walk-throughs,  unit  testing,  and  integration  testing.  These 
tests  are  performed  by  the  design  team.  Structured  design, 
design  walk-through  and  the  incorporation  of  "antibugging" 
facilitate  this  testing  by  exposing  and  addressing  problem  areas 
before  they  become  coded  "bugs." 


